🎲 10.1A – lancer_de
Objectif 🎯​
Écrire une Cloud Function appelable qui lance un dé, l'appeler depuis Flutter à travers l'émulateur, et valider les paramètres reçus du client.
Prérequis​
Avoir lu la recette Cloud Functions, en particulier les sections Ma première fonction, Passer des paramètres et Gérer les erreurs.
À faire 🛠️​
Étape 1 - Préparer le projet​
Choisissez votre point de départ :
- Le projet démo : téléchargez demo_cloud_functions. Il est déjà configuré pour l'émulateur, avec une fausse configuration Firebase.
- Votre propre projet : suivez la section Ajouter Cloud Functions Ă votre projet de la recette.
Ensuite :
- Dans un terminal, dans le répertoire
functions, exécuteznpm install, puisnpm run build:watch. - Dans un deuxième terminal, à la racine du projet, exécutez
firebase emulators:start. - Lancez l'application et vĂ©rifiez que l'appel Ă
helloWorldfonctionne avant d'aller plus loin.
COMMIT et PUSH.
Étape 2 - Écrire la fonction lancerDe​
Dans functions/src/index.ts, ajoutez une fonction appelable lancerDe qui retourne un nombre entier aléatoire de 1 à 6.
Math.random() retourne un nombre à virgule entre 0 (inclus) et 1 (exclu). Math.floor() retire la partie décimale d'un nombre.
- Vérifiez que le terminal de l'émulateur affiche une ligne
functions[us-central1-lancerDe]: http function initialized. - Écrivez le résultat de chaque lancer avec
logger.info. Vous le retrouverez dans l'onglet Logs de l'interface web des émulateurs (http://localhost:4000). - Lancez
npm run lintdans le répertoirefunctions, et corrigez les erreurs, s'il y en a.
COMMIT et PUSH.
Étape 3 - Afficher le résultat dans Flutter​
- Ajoutez un bouton Lancer le dé qui appelle
lancerDe. Le nombre retourné par la fonction est uninten Dart. - Affichez le résultat en gros caractères.
- Pendant l'appel, désactivez le bouton et affichez un indicateur de chargement.
- Arrêtez l'émulateur, puis appuyez sur le bouton : affichez un message compréhensible lorsque l'erreur reçue a le code
unavailable.
COMMIT et PUSH.
Étape 4 - Un dé à plusieurs faces​
Modifiez lancerDe pour qu'elle reçoive un paramètre faces, le nombre de faces du dé :
- si
facesest absent, la fonction lance un dé à 6 faces; - si
facesn'est pas un nombre entier entre 2 et 100, la fonction lance uneHttpsErroravec le codeinvalid-argumentet un message qui explique le problème; - sinon, la fonction retourne un nombre entier alĂ©atoire de 1 Ă
faces.
Number.isInteger(valeur) retourne true seulement si valeur est un nombre entier. Elle retourne false pour une chaîne comme "6".
Dans l'application, ajoutez un DropdownButton pour choisir parmi les dés 4, 6, 8, 12 et 20 faces, et envoyez la valeur choisie à lancerDe.
COMMIT et PUSH.
Étape 5 - Tester la validation​
Le menu déroulant n'envoie que des valeurs valides, mais rien n'empêche un client modifié d'envoyer autre chose. Dans votre code Flutter, remplacez temporairement la valeur envoyée par chacune des valeurs suivantes, et vérifiez que l'application affiche le message d'erreur de votre fonction :
110002.5'six'
Remettez ensuite la valeur du menu déroulant.
COMMIT et PUSH.
Étape 6 - Pour réfléchir 🤔​
Répondez à ces questions en commentaire au début de functions/src/index.ts :
- Si ce dé sert à un jeu en ligne, pourquoi est-ce plus intéressant de tirer le nombre dans une Cloud Function que dans l'application?
- Un joueur malhonnĂŞte peut quand mĂŞme appeler
lancerDeplusieurs fois, et ne garder que son meilleur résultat. Que devrait faire la fonction pour l'en empêcher?
COMMIT et PUSH.
Points clés à retenir​
- ✅ Le nom de la constante exportée est le nom de la fonction appelée par le client.
- ✅ Les paramètres envoyés par le client sont dans
request.data, et ils doivent toujours être validés. - ✅ Seules les erreurs lancées avec
HttpsErrorarrivent au client avec leur code et leur message. - ✅ Le code d'une Cloud Function s'exécute sur le serveur : c'est le seul code auquel on peut faire confiance.